QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Orientation Styles

QuickDraw 3D provides routines that you can use to manage orientation styles.

Q3OrientationStyle_New

You can use the Q3OrientationStyle_New function to create a new orientation style object.

TQ3StyleObject Q3OrientationStyle_New (
                     TQ3OrientationStyle frontFacingDirection);
frontFacingDirection
An orientation style value.

DESCRIPTION

The Q3OrientationStyle_New function returns, as its function result, a new style object having the orientation style specified by the frontFacingDirection parameter. The frontFacingDirection parameter should be one of these values:

kQ3OrientationStyleCounterClockwise
kQ3OrientationStyleClockwise

If a new style object could not be created, Q3OrientationStyle_New returns the value NULL .

To change the current orientation style, you must actually draw the style object. You can call Q3Style_Submit to draw the style in retained mode or Q3OrientationStyle_Submit (described next) to draw the style in immediate mode.

SEE ALSO

See "Orientation Styles" for a description of orientation styles.

Q3OrientationStyle_Submit

You can use the Q3OrientationStyle_Submit function to submit a orientation style in immediate mode.

TQ3Status Q3OrientationStyle_Submit (
                     TQ3OrientationStyle frontFacingDirection,
                     TQ3ViewObject view);
frontFacingDirection
An orientation style value.
view
A view.

DESCRIPTION

The Q3OrientationStyle_Submit function sets the orientation style of the view specified by the view parameter to the style specified by the frontFacingDirection parameter.

SPECIAL CONSIDERATIONS

You should call Q3OrientationStyle_Submit only in a submitting loop.

Q3OrientationStyle_Get

You can use the Q3OrientationStyle_Get function to get the orientation style value of an orientation style.

TQ3Status Q3OrientationStyle_Get (
                     TQ3StyleObject frontFacingDirectionObject,
                     TQ3OrientationStyle *frontFacingDirection);
frontFacingDirectionObject
An orientation style object.
frontFacingDirection
On exit, a pointer to the orientation style value of the specified orientation style object.

DESCRIPTION

The Q3OrientationStyle_Get function returns, in the frontFacingDirection parameter, a pointer to the current orientation style value of the style object specified by the frontFacingDirectionObject parameter.

Q3OrientationStyle_Set

You can use the Q3OrientationStyle_Set function to set the orientation style value of a orientation style.

TQ3Status Q3OrientationStyle_Set (
                     TQ3StyleObject frontFacingDirectionObject,
                     TQ3OrientationStyle frontFacingDirection);
frontFacingDirectionObject
An orientation style object.
frontFacingDirection
An orientation style value.

DESCRIPTION

The Q3OrientationStyle_Set function sets the orientation style value of the style object specified by the frontFacingDirectionObject parameter to the value specified in the frontFacingDirection parameter.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |